home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILFILE / AFL.LZH / AFL.DOC next >
Text File  |  1992-05-02  |  13KB  |  331 lines
  1.  
  2.  
  3.  
  4.   `                       Auto File Loader v1.3
  5.                     Copyright 1991 Shareware Solutions
  6.  
  7.  
  8.        PLEASE NOTE THE DISTRIBUTION RESTRICTIONS AND A VERY SPECIAL
  9.   OFFER AT THE END OF THIS DOCUMENT!  VERY IMPORTANT!  
  10.  
  11.  
  12.   INTRODUCTION
  13.  
  14.        The Auto File Loader program is a simple utility that I wrote
  15.   because I needed it to run some music files using the TrakBlaster
  16.   program. (A great PD program for those who have a SoundBlaster music
  17.   board.)  After adding a few features I began to realize that even
  18.   though it was simple it had some interesting possibilities.
  19.  
  20.        Basically all it does is bring up the current directory and
  21.   allow you to shell out and run any of the files with a program that
  22.   you choose.  For example the TrakBlaster program plays music files. 
  23.   The syntax for running a music file is, TRAK FILENAME.MOD.  When the
  24.   TrakBlaster program has finished playing a file it returns to DOS. 
  25.   To play another file you've got to type the command again using a
  26.   different filename.  This can be a real drag if you've got a lot of
  27.   files, hence the Auto File Loader program.  With AFL you can tag any
  28.   files you like and play them one at the time or you can have the
  29.   program play them randomly.
  30.  
  31.  
  32.   WHAT GOOD IS IT...
  33.  
  34.        So far I've found only a few good uses for this program but when
  35.   you need what this program does it's invaluable.  It's most valuable
  36.   use by far would be it's potential for running customized batch files
  37.   that perform repeated tasks on different files or directories.  
  38.  
  39.        1.   It's great for running music, graphic, and speech
  40.             files.  It's interface provides a convenient platform
  41.             for running any kind of program that executes a
  42.             function then returns to DOS.
  43.  
  44.             For example, if you use a file viewing program as the
  45.             RUN file and *.* (or *.DOC or *.TXT) as the mask you
  46.             could you could bring up all the documentation files
  47.             then tag them all and view them one after the other.
  48.  
  49.        2.   In my work I support a forty node LAN with more than
  50.             sixty users.  If you've ever worked with a LAN and
  51.             needed to add a file or make a change to a number of
  52.             files in separate directories you can easily
  53.             appreciate this program's potential. 
  54.  
  55.             By setting it's file mask to *. the program will bring
  56.             up all of the sub-directories in the current
  57.             directory.  By writing a batch file that does a simple
  58.             function you can have AFL repeat the batch file for
  59.             each user's personal directory.
  60.  
  61.             For example you might need to replace a configuration
  62.             file for thirty or forty different users.  To make
  63.             this long, drawn out task a thing of ease you would
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.             simply write a batch file that copied the new
  71.             configuration file into the users directory using the
  72.             %1 parameter. (If you don't know how to pass batch
  73.             files parameters you're missing out!  You can make
  74.             batch files do all kinds of work for you.)  You would
  75.             then run AFL using the *. file mask and use the name
  76.             of your batch file as the RUN file.  When the program
  77.             displays a directory it will list all of the sub-
  78.             directories. (It will also list any file names without
  79.             an extension.)  You can now tag any of the user's
  80.             personal directory names to pass to your batch file. 
  81.             When you press ENTER the batch file will execute for
  82.             each directory you've tagged.  Quick as a wink a
  83.             thirty minute job is over and you can go back to
  84.             reading PC magazine.
  85.  
  86.        3.   AFL makes a decent platform to run programs from, kind'ov
  87.             like a cheap imitation for a menu system.  It's one
  88.             advantage is it's ability to tag files and execute them one
  89.             at the time.  For example if you set the file mask to *.*
  90.             (or .COM or .EXE) and the RUN file to NUL (meaning nothing,
  91.             blank, etc...) you can use AFL to tag and run a few
  92.             utilities.  It can be a time saver if you want to go watch
  93.             the tube while your PC runs CHKDSK, then a virus scanner or
  94.             a disk optimization program.  
  95.  
  96.        4.   If you use a DOS command as the RUN file such as DEL or
  97.             RMDIR you can use AFL to tag files for deletion.
  98.  
  99.  
  100.        If there's any interest at all in this program (meaning
  101.   registrations) I'll try to add a feature that lets you tag programs
  102.   then enter any parameters you might wish to run them with. 
  103.  
  104.  
  105.   SET-UP, INSTALLATION, ETC...
  106.  
  107.        When you install the AFL program on your hard disk you should
  108.   copy it into a directory that can be found using the PATH command. 
  109.   The reason is that AFL brings up the directory of the currently
  110.   logged drive.  This way you'll only need one copy of AFL to run
  111.   multiple configurations.  That's about it for the installation.
  112.        The first time you run the AFL program it will try to write a
  113.   tiny little 17 byte configuration file called AFL.CFG into the
  114.   currently logged drive.  (If you run this program from a CD-ROM it
  115.   will inform you that it could not write if configuration and carry
  116.   on...)  This little file stores the name of the RUN file and the file
  117.   mask.  The first time AFL is run this file will be empty.  When you
  118.   change these options from the menu they will automatically be saved. 
  119.   By saving the configuration in the directory the program is run in
  120.   you can run AFL for different kinds of files without having to reset
  121.   the file mask and RUN file.
  122.  
  123.  
  124.   HOW TO USE AFL...
  125.  
  126.        The first thing you need to do is install it. (See above) The
  127.   next thing to do is change to the directory you wish to run it from
  128.   then type AFL and press ENTER.  From the menu you should change the
  129.   File Mask then the RUN file.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.   THE FILE MASK
  137.  
  138.        The FILE MASK is simply tells the program what kind of files to
  139.   list in it's file directory.  A fike mask of *.* will display every
  140.   file in the directory.  A file mask of *. will display only the sub-
  141.   directories and any filenames that do not have extensions.  You may
  142.   include a path along with the mask.
  143.  
  144.   THE RUN FILE
  145.  
  146.        The RUN FILE is the executable file you wish to pass file names
  147.   of directory names to.  The real power of this program is when you
  148.   use a batch file to perform multiple tasks.  The run file can be
  149.   preceded with a path.
  150.  
  151.     (Note: The program automatically turns off the CAPS LOCK and NUM
  152.   LOCK keys. This is necessary for the ESC key to work properly in the
  153.   random file play mode.) 
  154.  
  155.  
  156.   1. TAG FILES TO RUN
  157.  
  158.        Selecting this option will bring up a sorted directory using the
  159.   set file mask for the currently logged directory.  Use the ARROW keys
  160.   to hi-light file names and the + and - keys to tag or untag file
  161.   names.  Pressing a letter will jump to the first filename that begins
  162.   with the pressed letter.  Press ENTER to execute the tagged files.
  163.  
  164.  
  165.   2. RUN FILES 1 AT THE TIME
  166.  
  167.        The second choice, Run files 1 at the time, works exactly the
  168.   same as the Tag files option with one difference.  This options lets
  169.   you hi-light a file then press RETURN to have it execute immediately. 
  170.   You cannot tag files using this option.  If you press a letter to
  171.   jump to a file it will execute the first one it comes to having the
  172.   letter you pressed.
  173.  
  174.  
  175.   KEY FUNCTIONS
  176.  
  177.        Use ARROW keys, PGUP, PGDN, HOME and END keys to move
  178.        around the file list.
  179.  
  180.        Use the + and - keys to tag or untag files.  (Option #1 only.)
  181.  
  182.        Press any letter to jump to a file that begins with the pressed
  183.        letter.  Subsequent presses of the same letter will jump to the
  184.        next filename beginning with the pressed letter.  (The routine
  185.        allways searches from the cursor down.)
  186.  
  187.        Press ESC to return to a previous screen.  In random play mode
  188.        press ESC twice to return to AFL.
  189.  
  190.        Press ENTER to execute the tagged or hi-lighted file(s).
  191.  
  192.        Press the SPACE BAR to tag or untag all files.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.   1. RUN ALL FILES RANDOMLY
  203.  
  204.        This option does what it says.  It just starts executing files
  205.   at random.  It has limited use but can be handy for music or graphic
  206.   file.  It could even be used as a random selection generator.  For
  207.   example if you needed to randomly select individual names just put
  208.   each name into a batch file that echo's each name tothe screen, set
  209.   the file mask to *.BAT and the run file to null (nothing).  Now when
  210.   you select random play all the names will be displayed on the screen
  211.   randomly.  Think about it...
  212.        The only thing to note here is that pressing the ESC button
  213.   twice will allow you to exit the random routine.  If that doesn't
  214.   work pressing CTRL-BREAK will.
  215.  
  216.  
  217.   THE LEGAL STUFF
  218.  
  219.        Under no circumstances shall Shareware Solutions be liable for
  220.   any damages, including lost profits, savings, or any other incidental
  221.   or consequential damages arising out of the use of or inability to
  222.   use this program, even if Shareware Solutions has been notified of
  223.   the possibility of such damages, or for any claims by any other
  224.   party.  Copyright (C) 1991 Shareware Solutions. 
  225.  
  226.  
  227.  
  228.   SHAREWARE SOLUTIONS
  229.  
  230.   PRICING - REGISTRATION
  231.  
  232.        That's about it.  It's a simple program that does a simple job
  233.   but if you ever need it it's simply invaluable.  So If you use this
  234.   program in any kind of environment that makes your life a bit easier
  235.   it ought to be worth a few bucks, say about $10.00 for a registered
  236.   version and a clear conscience.  If you decide it's worth something
  237.   you can send your registration payment to:
  238.  
  239.  
  240.        Shareware Solutions
  241.        Michael L. Wester
  242.        Route #6 Box 34
  243.        Fuquay-Varina, N.C
  244.        27526
  245.  
  246.  
  247.   DISTRIBUTION RESTRICTIONS
  248.  
  249.        This is a shareware program.  This means share it!  You are free
  250.   to distribute evaluation copies to anyone you choose.  Disk vendors
  251.   are also encouraged to include this program in thier catalogs.  The
  252.   only restriction (and this is very important) is THIS PROGRAM MAY NOT
  253.   BE DISTRIBUTED ON A CD-ROM (compact disk) MEDIUM WITHOUT THE WRITTEN
  254.   PERMISSION OF THE AUTHOR.  Please note that we WILL persue litigation
  255.   if this copyrighted program is found on a CD-ROM without our
  256.   permission.
  257.  
  258.  
  259.   SPECIAL OFFER!
  260.  
  261.        By the way, Shareware Solutions is a small business running a
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.   shareware software library that offers over 2800 of the latest,
  269.   greatest and absolute best shareware programs available.  (We also
  270.   sell our entire library on CD-ROM!  The CD-ROM version contains a
  271.   complete database of the entire library complete with descriptions,
  272.   the ability to print labels, the automated ability to format disks
  273.   and copy programs at the same time and a NO ROYALITY distributable
  274.   catalog so you can start your own shareware business.  It's great for
  275.   computer store owners and entrepreneurs!  You get one of the best
  276.   libraries available and a complete buisiness with almost no effort! 
  277.   If interested call us at (919)-552-0767.)  We sell copies of
  278.   shareware programs for only $3.00 per disk!  Buy 5 get 1 free!  You
  279.   ask yourself, why should I buy this stuff when I obviously can get it
  280.   for the cost of a download?  Well right off hand I can only think of
  281.   a few reasonably decent reasons.
  282.  
  283.        1.   If you're calling long distance it'll be cheaper than
  284.             downloading large files.
  285.  
  286.        2.   All of our files have been tested.  We cull the junk!
  287.  
  288.        3.   We're an ASP APPROVED VENDOR!  We get the latest software
  289.             straight from the gurus who write it.
  290.  
  291.        4.   We offer a FREE disk catalog!  It has full, honest
  292.             descriptions, program requirements, and evaluations of what
  293.             we choose to be some of the best shareware available.
  294.  
  295.  
  296.        Did you know there are over 75,000 shareware and public domain
  297.   programs?  Do you really have time to check them all out?  Did you
  298.   know that over 50% of shareware registrations are made through vendor
  299.   sales?  
  300.  
  301.  
  302.        If you're a shareware author and would like to have your program
  303.   distributed in our catalog, send us a copy!  We'll evaluate it and if
  304.   it's not too common and of a good quality we'll put it in the
  305.   catalog.  (If there are a zillion other programs that do what your's
  306.   does your's will have to be better.)
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.